home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 May: Tool Chest / Dev.CD May 98 TC.toast / Tool Chest / Development Kits / • Other Platforms / PCCTS 1.31 / Documentation / dlg1.txt < prev    next >
Encoding:
Text File  |  1995-03-10  |  3.5 KB  |  125 lines  |  [TEXT/MPS ]
  1.  
  2.  
  3.  
  4. dlg - DFA Lexical Analyzer Generator
  5.  
  6.  
  7. dlg [options] lexical_spec [output_file]
  8.  
  9. dlg is a tool that produces fast  deterministic  finite  automata  for
  10. recognizing regular expressions in input.
  11.  
  12.  
  13. -CC  Generate C++ output.  The output_file is not  specified  in  this
  14.      case.
  15.  
  16. -C[ level]
  17.      Where level is the compression  level  used.   0  indications  no
  18.      compression,  1 removes all unused characters from the transition
  19.      from table, and 2 maps equivalent characters into the same  char-
  20.      acter  classes.  It is suggested that level -C2 is used, since it
  21.      will significantly reduce the size of the dfa produced for  lexi-
  22.      cal analyzer.
  23.  
  24. -m   Produces the header file for the lexical mode with a  name  other
  25.      than the default name of "mode.h".
  26.  
  27. -i   An interactive, or as interactive as  possible,  parser  is  pro-
  28.      duced.   A  character  is  only  obtained when required to decide
  29.      which state to go to.  Some care must be taken to  obtain  accept
  30.      states  that  do  not require look ahead at the next character to
  31.      determine if that is the stop state.  Any regular expression with
  32.      a  Kleene  closure  at  the  end is guaranteed to require another
  33.      character of look ahead.
  34.  
  35. -cl class
  36.      Specify a class  name  for  DLG  to  generate.   The  default  is
  37.      DLGLexer.
  38.  
  39. -ci  The automaton will treat upper and lower case characters  identi-
  40.      cally.   This is accomplished in the automaton; the characters in
  41.      the lexical buffer are unmodified.
  42.  
  43. -cs  Upper and lower case characters are treated as distinct.  This is
  44.      the default.
  45.  
  46. -o dirDirectory where output files should go (default=".").   This  is
  47.      very nice for keeping the source directory clear of ANTLR and DLG
  48.      spawn.
  49.  
  50. -Wambiguity
  51.      Warns if more than one regular expression could  match  the  same
  52.      character sequence.  The warnings give the numbers of the expres-
  53.      sions in the dlg lexical specification file.   The  numbering  of
  54.      the  expressions  starts  at one.  Multiple warnings may be print
  55.      for the same expressions.
  56.  
  57. -    Used in place of file names to get input from standard in or send
  58.  
  59.  
  60.  
  61.                                                                 Page 1
  62.  
  63.                                                                  PCCTS
  64.  
  65.  
  66.      output to standard out.
  67.  
  68.  
  69.      Dlg works...  we think.  There is no implicit guarantee  of  any-
  70. thing.  We reserve no legal rights to the software known as the Purdue
  71. Compiler Construction Tool Set  (PCCTS)  -  PCCTS  is  in  the  public
  72. domain.   An  individual  or  company  may  do whatever they wish with
  73. source code distributed with PCCTS or the  code  generated  by  PCCTS,
  74. including  the  incorporation of PCCTS, or its output, into commercial
  75. software.  We encourage users to develop software  with  PCCTS.   How-
  76. ever,  we  do ask that credit is given to us for developing PCCTS.  By
  77. "credit", we mean that if you incorporate our source code into one  of
  78. your  programs  (commercial  product,  research project, or otherwise)
  79. that  you  acknowledge  this  fact  somewhere  in  the  documentation,
  80. research  report,  etc...  If you like PCCTS and have developed a nice
  81. tool with the output, please  mention  that  you  developed  it  using
  82. PCCTS.   As  long  as these guidelines are followed, we expect to con-
  83. tinue enhancing this system and expect to make other  tools  available
  84. as they are completed.
  85.  
  86. mode.h , dlgauto.h , dlgdef.h
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                                                 Page 2
  124.  
  125.